home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / lisp / stk-3.002 / stk-3 / STk-3.1 / Tk / win / README < prev    next >
Encoding:
Text File  |  1996-04-14  |  3.6 KB  |  102 lines

  1. Tk 4.1 for Windows
  2.  
  3. by Scott Stanton
  4. Sun Microsystems Laboratories
  5. scott.stanton@eng.sun.com
  6.  
  7. SCCS: @(#) README 1.11 96/04/12 16:41:48
  8.  
  9. 1. Introduction
  10. ---------------
  11.  
  12. This is the directory where you configure and compile the Windows
  13. version of Tk.  This directory also contains source files for Tk
  14. that are specific to Microsoft Windows.  The rest of this file
  15. contains information specific to the Windows version of Tk.
  16.  
  17. 2. Distribution notes
  18. ---------------------
  19.  
  20. Tk 4.1 for Windows is distributed in binary form in addition to the
  21. common source release.  The binary distribution is a self-extracting
  22. archive with a built-in installation script.
  23.  
  24. Look for the binary release in the same location as the source release
  25. (ftp.smli.com:/pub/tcl or any of the mirror sites).  For most users,
  26. the binary release will be much easier to install and use.  You only
  27. need the source release if you plan to modify the core of Tcl, or if
  28. you need to compile with a different compiler.  With the addition of
  29. the dynamic loading interface, it is no longer necessary to have the
  30. source distribution in order to build and use extensions.
  31.  
  32. 3. Compiling Tk
  33. ----------------
  34.  
  35. In order to compile Tk for Windows, you need the following items:
  36.  
  37.     Tcl 7.5 Source Distribution (plus any patches)
  38.     Tk 4.1 Source Distribution (plus any patches)
  39.  
  40.     The latest Win32 SDK header files
  41.  
  42.     Borland C++ 4.5/5.0 (32-bit compiler)
  43.       or
  44.     Visual C++ 2.x/4.0
  45.     
  46.  
  47. In the "win" subdirectory of the source release, you will find two
  48. files called "makefile.bc" and "makefile.vc".  These are the makefiles
  49. for the Borland and Visual C++ compilers respectively.  You should
  50. copy the appropriate one to "makefile" and update the paths at the top
  51. of the file to reflect your system configuration.  Now you can use
  52. "make" (or "nmake" for VC++) to build the tk libraries and the wish
  53. executable.
  54.  
  55. In order to use the binaries generated by these makefiles, you will
  56. need to place the Tk script library files someplace where Tk can
  57. find them.  Tk looks in one of two places for the library files:
  58.  
  59.     1) The environment variable "TK_LIBRARY".
  60.     2) Relative to the directory containing the Tk DLL.
  61.         Tk will look for a directory "..\lib\tk4.1" relative to the
  62.         directory containing the tk41.dll loaded by the currently running
  63.         application.
  64.  
  65. Note that in order to run wish41.exe, you must ensure that tcl75.dll
  66. (and tcl1675.dll under Win32s), tk41.dll are on your path, or in the
  67. directory containing wish41.exe.
  68.  
  69. 4. Test suite
  70. -------------
  71.  
  72. The Windows version of Tk does not pass many of the tests in the test
  73. suite.  This is primarily due to dependencies in the test suite on the
  74. size of particular X fonts, and other X related features.  We will be
  75. working to develop a more general test suite for Tk under Windows, but
  76. for now, you will not be able to pass many of the tests.
  77.  
  78. 5. Known Bugs
  79. -------------
  80.  
  81. Here is the current list of known bugs/missing features for the
  82. Windows beta version of Tk:
  83.  
  84. - There is no support for custom cursors/application icons.
  85. - Stippling of arcs isn't implemented yet.
  86. - Some "wm" functions don't map to Windows and aren't implemented.
  87. - There is no support for the option database yet.
  88. - Under Win32s, you can only start one instance of Wish at a time.
  89. - Traversing the items in a menubar causes the titlebar of the window
  90.   to flash.
  91. - Color management on some displays doesn't work properly resulting in
  92.   Tk switching to monochrome mode.
  93. - Send and winfo interps are not currently supported
  94.  
  95. If you have comments or bug reports for the Windows version of Tk,
  96. please direct them to:
  97.  
  98. Scott Stanton
  99. scott.stanton@eng.sun.com
  100.  
  101. or post them to the newsgroup comp.lang.tcl.
  102.